home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
FishMarket 1.0
/
FishMarket v1.0.iso
/
fishies
/
376-400
/
disk_382
/
crossdos
/
crossdos.lzh
/
CrossDOS.manual
< prev
next >
Wrap
Text File
|
1990-10-05
|
63KB
|
1,829 lines
wCrossDos
Version 4.00b READONLY w
wThe MS-DOS File System
w
CONSULTRON
11280 Parkview, Plymouth MI 48170
Copyright (c) 1989,1990 CONSULTRON. All Rights Reserved.
Author: Leonard Poma
Date: August 20th, 1990
CrossDOS ... The MS-DOS File System
w1 INTRODUCTION
w
CrossDos is a software product that allows the user to read
and write MS-DOS/PC-DOS and Atari ST formatted disks
(Version 2.0 or higher) directly from AmigaDOS. It fully
integrates itself into the Amiga operating system to allow
your MS-DOS formatted disks to be accessed from virtually
any utility or application. This allows you to access any
MS-DOS file just as you would any other Amiga file.
The release you presently have is a "READONLY" version of
the CrossDos. It is a fully functional version of the
product with all writing functions disabled. If any writes
are attempted to the MS-DOS disk you will get a
"Write-Protected" requestor to pop-up.
NOTE
All further references to MS-DOS formatted disks also
apply to PC-DOS and Atari ST formatted disks unless
otherwise specified.
NOTE
References to functions that require the ability to
write do not apply for this release. These references
are included so that you may know how they handled in
the READ/WRITE version. Although the use of CrossDos
is very simple and user transparent, a manual is
supplied for technical reference.
1.1 Feature Summary
A summary of the main features of CrossDos (READ/WRITE
version) are:
- MS-DOS formatted disks are integrated as part of the
Amiga operating system allowing access from virtually any
Amiga utility or application (including file
requesters). Perform most AmigaDOS functions:
- Read and write any file.
- Relabel the disk name.
- Create directories.
- Rename any files or directories within or across
directories.
- Set file or directory dates and protection bits.
- MS-DOS formatted disks (Versions 2.0 and higher) are
supported.
- standard density, 80 track, 3 1/2" floppies (720 K)
- standard density, 80 track, 5 1/4" floppies (720 K)
- standard density, 80 track, 5 1/4" floppies used in
double track step mode (360 K)
- standard density, 40 track, 5 1/4" floppies (360 K)
- Two ASCII text filter options are provided (including
international character translation).
- Disk changes are sensed automatically (if the drive
1-1
CrossDOS ... The MS-DOS File System
provides the proper hardware signal).
- Floppy disk parameters are sensed automatically (ie.
double-sided, single-sided, 8 or 9 sectors/track,
etc.).
- ".info" file extensions are supported for use with
WORKBENCH.
- Double Track Step Mode is available to read and write
standard 40 track floppies on an 80 track, 5 1/4"
drive.
- Minimal memory is required (approx. 80 bytes) when the
file system is not accessed.
- "Kill" utility can be used to recover resources and
memory after use.
- Special utilities to format, diskcopy and check the
integrity of MS-DOS disks are provided.
- Software is not copy-protected.
1.2 Hardware Requirements
CrossDos requires a standard Amiga (500, 1000, 2000, or
2000HD) with at least 256K bytes of memory.
This product includes a special device driver,
"mfm.device", for use with 3 1/2" and 5 1/4" floppy
drives.
1.3 Software Requirements
CrossDos requires the Amiga operating system to be Version
1.2 or higher. The product at the time of this document
has been tested under Versions 1.2 and 1.3.
You must also use a Version 1.3 compatible "mount"
command. This command is included in this product.
1.3.1 Minimum Files Needed
The following are files needed to mount an MS-DOS device.
L:MSDOSFileSystem -- always
DEVS:mfm.device -- when using floppy disks
(3 1/2" or 5 1/4")
C:Mount -- always (V1.3 compatible)
C:TDPatch12 or C:TDPatch13 -- only if one 3 1/2" drive
installed in Amiga
1.4 Product Limitations
High density formatted disks (1.2M and 1.44M disks
formatted on the IBM-AT and PS/2) are incapable of being
1-2
CrossDOS ... The MS-DOS File System
read due to current limitations in the standard Amiga
hardware. Currently, the standard Amiga floppy drive
hardware is capable of reading/writing standard density
formatted floppies (360K and 720K) on 3 1/2" and 5 1/4"
drives. Please note though, high density drives on
IBM-compatible machines are capable of formatting, reading
and writing standard density formats.
CrossDos
CANNOT
directly execute any of the MS-DOS,
PC-DOS or Atari ST executable files (such as .EXE or .COM
files) although it can transfer these files to or from the
MS-DOS disk. To execute these files on the Amiga you would
need an emulator program such as the "Transformer" from
Commodore which is not provided in this product.
CrossDos may not read or write copy-protected MS-DOS
disks. Although it may read most of the disk, it cannot
"crack" the protection technique used on the disk. Writing
to a copy-protected MS-DOS disk is
NOT
recommended.
There are file naming limits imposed by the MS-DOS disk
format of eight alphanumeric characters for the file name
and three for the file extension. Refer to section
"
AmigaDOS COMPATIBILITY
" for further explanation.
The MS-DOS disk format does not allow file comments so that
this AmigaDOS function is not supported.
1-3
CrossDOS ... The MS-DOS File System
w2 "TRYWARE"
w
What is "TRYWARE" you say? That is a valid question. Just
as the name implies, you try something. In this case, you
try the "READONLY" version of CrossDos. If you like it and
you need to write to MS-DOS disks, purchase the
"READ/WRITE" version for a modest amount.
We at CONSULTRON are just like anyone else. We would like
to try any software first before we "fork over the big
bucks". This is not a new idea, but it is sorely
under-utilized. Others have tried this idea in its various
forms (ie. shareware), with mixed success.
We at CONSULTRON are also trying something risky. We are
pricing this product well below what you might expect for
something of this complexity. The only way we can succeed
at this price is to cut overhead to the bone. When you buy
any commercial product, not only are you paying for the
materials, the development costs and support personnel, you
are also paying for advertising in magazines and other
promotional effects. We have nothing against commercial
promotion, but those costs may contribute anywhere from 10
to 50 percent to the cost of the product.
We ask YOU to become the bulk of our advertising. Once you
see that this is a quality product, we hope you tell others
about it. In fact, make them a copy of this "READONLY"
release so that they may try it for themselves.
2-1
CrossDOS ... The MS-DOS File System
w3 INSTALLATION
w
The installation instructions for mounting an MS-DOS device
on the Amiga are detailed in the following sections. A
simple program is included in this product for installation
of standard 3 1/2" or 5 1/4" floppy drives.
3.1 Backup Your Original Product Disk
This product is not copy-protected so that you may make a
backup and/or transfer the necessary files to a hard
disk. Refer to section "
COPYRIGHT
" for copyright
restrictions before proceeding.
We recommend that you backup this product disk before
proceeding with any installation or modification. Using
the "diskcopy" utility (or equivalent), copy the original
disk included with this product to a disk for backup.
Store the original disk in a safe, cool location away from
magnetic fields. Use your backup copy for any further
accesses.
3.2 Installing CrossDOS
There are two methods we provide to install and use
CrossDos. One method is recommended for users who do not
have disk space (about 30K) on their system disk for the
minimum files needed to run the MS-DOS file system. The
second method is to install the product onto your system
disk. This allows for the quickest access for users with
multiple drives (including hard drives).
3.2.1 Method 1 -- Immediate Use
For users who do not have the disk space on their system
disk or do not wish to install the software, we provide a
program that will "mount" and "load" the desired MS-DOS
device directly from the product disk supplied. Refer to
the section "
ATTACH
" on how to use this command.
3.2.2 Method 2 -- System Installation
For users that wish to install CrossDos on their system
disk, we provide a simple installation program either
executable from the CLI or the WORKBENCH. This program
need only to be executed once for each system disk you wish
to install CrossDos on.
To execute the program from the CLI, type the following:
MSDOS_FileSystem:Install_MSDOSFS
3-1
CrossDOS ... The MS-DOS File System
To execute the program from the WORKBENCH, double-click on
the disk icon
MSDOS_FileSystem
supplied with this
product, then double-click on the tool icon named
Install_MSDOSFS
.
Answer the questions presented on the computer screen to
complete the installation of this product in your system.
If you wish to modify your "startup-sequence" or
"mountlist" files, you can edit these after the
installation sequence.
3.2.3 Mounting an MS-DOS Device
Once all the required files are installed in the proper
directories, only "mounting" the device is needed to have
the Amiga recognize the MS-DOS device. To "mount" the
internal drive, as an example, enter the command from the
CLI:
mount DI0: FROM DEVS:mountlist.msdosFS
The "mount" command can be executed when needed or can be
inserted in a startup file such as "S:startup-sequence".
Once the device is successfully "mounted", the device can
be accessed by any utility or application by specifying the
device name (e.g. DI0:).
3.3 Double Track Step Mode
The Double Track Step Mode is used to allow standard 40
track, 5 1/4" floppies to be read or written on 80 track
floppy drives. This mode can be used on 3 1/2" drives but
there probably would be no need to.
The Double Track Step Mode actually steps the drive head
two steps instead of one. To set this mode, the mountlist
parameter, "Dostype =", for the desired device must be set
to 0x4D444400 ( MDD ).
A word of caution must be noted about using the Double
Track Step Mode on 80 track, 5 1/4" drives. Because
read/write heads on 80 track drives are half the width of
heads on 40 track drives, reading data reliably may at
times be difficult.
3-2
CrossDOS ... The MS-DOS File System
w4 AmigaDOS COMPATIBILITY
w
The MS-DOS File System is designed to conform to AmigaDOS
and MS-DOS file naming conventions wherever possible as
well as multi-tasking requirements (such as file locks).
There are a few exceptions due to the limitations of MS-DOS
file naming conventions. The following sections detail the
differences.
4.1 File Naming Conventions
File naming conventions for MS-DOS still apply when
accessing or creating file or directory names.
4.1.1 Invalid Characters
The following is a list of characters that are not valid
for MS-DOS names.
< > . " | + = ; , \ / [ ] :
Although some of these characters are valid for AmigaDOS
filenames, avoid them. The characters '\', '/', '[', ']',
':' are reserved for special use as described below.
4.1.2 File Name ("FileName")
The file (or directory) name is limited to 8 alphanumeric
characters. Any characters beyond 8 are ignored. The
characters can be specified as lowercase and will be
converted to uppercase automatically. The space character
' ' is allowed between other alphanumeric characters but it
is not recommended.
DI0:FILENAME
ignored
becomes DI0:FILENAME
4.1.3 File Extension (".Ext")
The file (or directory) extension is limited to 3
alphanumeric characters. Any characters beyond 3 are
ignored. The extension appears after the dot ('.') but it
is not necessary in a file name. The characters can be
specified as lowercase and will be converted to uppercase
automatically. The space character ' ' is allowed between
other alphanumeric characters but it is not recommended.
If multiple extensions are present in a file name, only the
last extension will be used.
DI0:FILENAME
ign.ign
.EXT
ignored
becomes DI0:FILENAME.EXT
4-1
CrossDOS ... The MS-DOS File System
4.1.3.1 WORKBENCH Extension (".info")
One exception to the 3 character extension is the Amiga
extension ".info". When the file name is read from the
MS-DOS disk by the MS-DOS File System, an ".INF" extension
is automatically expanded to ".info" to allow the file to
be seen by the WORKBENCH application. Subsequently, when a
file is written to the MS-DOS disk with an ".info"
extension, it is stored on the disk as ".INF".
The original file that will have a WORKBENCH ".info" file
associated with it must not have any other extensions in
the name. If the original file already has an extension,
it may not be properly accessed by WORKBENCH. Create files
on the MS-DOS disk with NO file extension so that
applications that automatically create ".info" files will
then work correctly.
4.1.4 Root Name Qualifier (':')
The character ':' is used as a root name qualifier to refer
to the physical device name, the volume name of the disk
or the logical name of a directory path.
DI0:FILENAME.EXT
4.1.5 Volume Name ("Volume_Name")
The volume name is limited to 11 alphanumeric characters
with spaces allowed between characters. Any characters
beyond 11 are ignored. The characters can be specified as
lowercase and will be converted to uppercase
automatically.
The volume name is normally written on the disk during a
format. Since the volume name is optional to MS-DOS, it
may not appear in the root directory of the disk. When the
volume name is not available, the MS-DOS File System will
use the boot block identification name and a creation date
of January 1, 1980 as the volume information for AmigaDOS.
"IBM 3.1:FILENAME.EXT" equals DI0:FILENAME.EXT
4.1.6 Directory Name Qualifiers ('/' or '\')
The directory name qualifiers can be the standard AmigaDOS
'/' or MS-DOS '\' characters. The characters '/' and '\'
are used to separate directory paths.
DI0:SUBDIR/FILENAME
DI0:SUBDIR\SUBSUBDIR/FILENAME
4-2
CrossDOS ... The MS-DOS File System
4.2 File Filters
Normally the MS-DOS File System will transfer data
unmodified between the MS-DOS disk and the Amiga. There
may be occasions where certain file translating (filtering)
may be desired. Two types of text filters are provided by
the MS-DOS File System as options.
4.2.1 CTRL-M/CTRL-Z Filter (']')
MS-DOS text files normally have carriage returns (CTRL-M)
followed by linefeeds (CTRL-J) whereas the Amiga only needs
linefeeds. They also place one or more EOFs (CTRL-Z) at
the end of the file to signal the end-of-file which is also
not used by the Amiga. If you wish to filter the carriage
returns and EOFs, place the character ']' anywhere in the
file specification (appended to the end of the name works
best). The filter removes carriage returns and EOFs when
reading the file from the MS-DOS disk. The filter will add
carriage returns before linefeeds and an EOF to the end of
the text when writing the file to the MS-DOS disk.
The following example will copy a file from the MS-DOS disk
to an AmigaDOS disk and remove the carriage returns and the
EOFs during the transfer.
copy DI0:FILENAME.EXT] to DF0:FILENAME.EXT
A utility called "TxFilter" is supplied with this product
to allow you to set this filter on for all files without
having to specify the ']' in the name. This is
particularly useful when operating from WORKBENCH. Refer
to the section "
TxFilter
" on how to use this
command.
4.2.2 High Bit Filter/Int'l Translator ('[')
If you are using the standard MS-DOS file system, this
filter performs the High Bit Filter. Some MS-DOS word
processing files set the high bit of certain ASCII
characters in the file to give that character special
meaning. If you wish to filter the high bit to try to
conform the file to standard ASCII text, place the
character '[' anywhere in the file specification (appended
to the end of the name works best). The filter only clears
the high bit when reading the file from the MS-DOS disk.
The filter will not set the high bit when writing the file
to the MS-DOS disk.
If you are using the international MS-DOS file system, this
filter performs the international character translator.
Text files that contain international characters require
translation between the Amiga and MS-DOS systems. Both
4-3
CrossDOS ... The MS-DOS File System
systems use different ASCII codes to represent these types
of characters. Using this filter, it will attempt to
translate the international characters to or from either
system. You may use the global international character
translator button (refer to the utility "IntlTrans") in
place of this filter character.
The following example will copy a file from the MS-DOS disk
to an AmigaDOS disk and clears the high bit or translates
international characters during the transfer.
copy DI0:FILENAME.EXT[ to DF0:FILENAME.EXT
4.3 Sensing Disk Changes
The MS-DOS File System will automatically detect disk
changes if the drive used is compatible with Amiga hardware
requirements for disk change detection. The 3 1/2" drive
supplied with your Amiga is capable of disk change
detection, whereas most 5 1/4" drives sold by
Commodore-Amiga are not.
For those drives that do not have hardware to detect disk
changes, we have provided a command called "DiskChg" that
forces the MS-DOS File System to recognize a change of
disks.
4-4
CrossDOS ... The MS-DOS File System
w5 FILE LIST
w
This is the current listing of the CrossDos Version 4.00b
READONLY release:
PD (dir)
mount_jds.zoo V1.3 compatible mount cmd
c (dir)
TDPatch12 trackdisk.device patch for V1.2
TDPatch13 trackdisk.device patch for V1.3
Mount_JDS V1.3 compatible command
Mount_JDS.DI0.info Mount device project icon
Mount_JDS.DI1.info Mount device project icon
Mount_JDS.DI2.info Mount device project icon
Mount_JDS.DI3.info Mount device project icon
L (dir)
MSDOSFileSystem MS-DOS file system code
Devs (dir)
mfm.device mfm device driver code
mountlist.msdosFS partial mountlist for floppies
System (dir)
DiskChk check disk blocks
DiskChk.info
Kill kill handler or filesystem
Kill.info
Kill.DI0.info Kill project icon
Kill.DI1.info Kill project icon
Kill.DI2.info Kill project icon
Kill.DI3.info Kill project icon
MDiskCopy diskcopy utility for MS-DOS disks
MDiskCopy.info
DiskChg diskchange device command
DiskChg.info
DiskChg.DI0.info DiskChg project icon
DiskChg.DI1.info DiskChg project icon
DiskChg.DI2.info DiskChg project icon
DiskChg.DI3.info DiskChg project icon
TxFilter text filter command
TxFilter.info
TxFilter.DI0.info text filter project icon
TxFilter.DI1.info text filter project icon
TxFilter.DI2.info text filter project icon
TxFilter.DI3.info text filter project icon
MountMF program that mounts all floppies available
CrossDOS.manual The manual file
Install_msdosFS auto-installation program
Install_msdosFS.info
READ.ME last minute news and updates.
READ.ME.info
Tech_Ref Technical Reference information
Tech_Ref.info
5-1
CrossDOS ... The MS-DOS File System
System.info
Attach mount and load from installation disk
Attach.info
Attach.DI0.info Attach project icon
Attach.DI1.info Attach project icon
Attach.DI2.info Attach project icon
Attach.DI3.info Attach project icon
A format utility called "MFORMAT" will be provided in the
"READ/WRITE" version but not in this "READONLY" version.
5.1 MS-DOS File System Support Utilities
The following utilities are included with this product to
enhance your usage of CrossDos. These utilities can be run
from the CLI or from WORKBENCH.
5.2 "MountMF"
Format:
MountMF [devicename_prefix]
Template:
MountMF "DEVICENAME_PREFIX/A"
Purpose:
To "mount" all MS-DOS floppy devices.
Path:
MSDOS_FileSystem:MountMF
Specification:
This utility attempts to "mount" all MS-DOS floppy devices
connected to the Amiga. This utility can be executed from
WORKBENCH, the CLI or your startup-sequence. Placing this
command before the "LoadWB" command in your
startup-sequence seems to provide the most convenient
results.
The following is an example when using the command from the
CLI:
MSDOS_FileSystem:MountMF
To MountMF a device from WORKBENCH, double-click on the
MountMF icon.
The DEVICENAME_PREFIX option is available as TOOL TYPES
parameter in the project icons.
MountMF automatically executes the TDPatch command if
needed.
NOTE
If your system is using either Kickstart V1.2 or V1.3
ROMs, you MUST make sure that the appropriate TDPatch
(TDPatch12 or TDPatch13) is installed in your C:
directory for this command to work.
5-2
CrossDOS ... The MS-DOS File System
5.3 "Mount_JDS"
Format:
Mount_JDS <devicename> [FROM <file>]
Template:
Mount_JDS "DEVICENAME/A,FROM/K"
Purpose:
To create an AmigaDOS device node.
Path:
C:Mount_JDS
Specification:
This utility attempts to create an AmigaDOS device node.
In other words, Mount_JDS informs the Amiga that an
additional device has been added to the system. When the
Mount_JDS command is issued, Mount_JDS looks in the
DEVS:MountList file (or the optional FROM file) for the
parameters of the device that is being mounted. This
utility is only needed if you do not already have a V1.3
compatible "mount" command.
The following is an example when using the command from the
CLI:
Mount_JDS DI0: FROM DEVS:mountlist.msdosFS
To mount a device from WORKBENCH, double-click on the
Mount_JDS.<device> icon (such as "Mount_JDS.DI0").
The FROM, and DEVICENAME options are available as TOOL
TYPES parameters in the project icons. Refer to the
project icons supplied with this product for the format of
these parameters.
5.4 "Kill"
Format:
Kill <devicename>
Template:
Kill "DEVICENAME"
Purpose:
To remove a file system and free resources
Path:
C:Kill
Specification:
This utility attempts to Kill the MS-DOS File System that
is loaded. It will try to return all the resources and
memory allocated.
The following is an example when using the command from the
CLI:
Kill DI0:
To execute from WORKBENCH, double-click on the
Kill.<device> icon (such as Kill.DI0) or double-click on
the Kill icon and the program will prompt you to enter the
name of the device to Kill.
Caution must be exercised in using this command since it
5-3
CrossDOS ... The MS-DOS File System
does not check to make sure all the file locks are returned
to the file system before Killing it. If file locks still
exist after Killing the file system, any use of the lock
may crash the system.
Using this utility when WORKBENCH is running may "hang"
WORKBENCH. To recover from a hung WORKBENCH, issue a
"LoadWB" command from a CLI again.
Kill may work with other file systems but we do not
guarantee the results.
5.5 "DiskChk"
Format:
DiskChk <devicename>
Template:
DiskChk "DEVICENAME"
Purpose:
To check the read integrity of any disk
Path:
SYS:System/DiskChk
Specification:
This utility attempts to check the read validity of any
disk and report any errors.
The following is an example when using the command from the
CLI:
DiskChk DI0:
It will interactively ask which blocks to check ( lower and
upper limits). If the character "r" is place after the
upper limit value entered, DiskChk will "repeat" the
checking until a Control-C is typed.
This utility was originally designed to check MS-DOS
formatted disks but it should work on any disk mounted on
the Amiga.
To check disks from WORKBENCH, select the desired MS-DOS
disk icon then (with shift key held) double-click on the
DiskChk icon.
5.6 "MFormat"
Format:
MFormat DRIVE <devicename> NAME <diskname> [QUICK]
[NOVERIFY] [FAST] [FMT=MQD9|MD9|MS9|AD9|AS9]
Template:
MFormat "DEVICENAME,DISKNAME,QUICK/S,NOVERIFY/S,
FMT/K"
Purpose:
Format a disk using an MS-DOS format
Path:
SYS:System/MFormat
Specification:
This utility will format a disk an MS-DOS format using some
of the parameters in the mountlist or an explicit disk
5-4
CrossDOS ... The MS-DOS File System
format (FMT=).
The QUICK option will only reformat an MS-DOS disk that
previously had the same format. It will supply a new boot
block, file allocation tables and the root directory with
the volume name as the only entry.
The NOVERIFY option will not perform a verify after
formatting a cylinder. Using this option will perform a
quicker physical format of the disk but the resulting disk
is not checked for errors. The QUICK option overrides the
NOVERIFY option.
The FAST option is faster than the NOVERIFY option and
consequently checks even less of the format integrity. The
QUICK option overrides the FAST option.
The FMT option allows another format to be used instead of
the default format resulting from parameters in the
mountlist for the device. Only one format specification is
allowed after the FMT keyword.
The following is an example when using the command from the
CLI:
MFormat DRIVE DI0: NAME "MSDOS_DISK" NOVERIFY FMT=MQD9
The following table lists the important parameters of the
supported disk formats.
Format| Format| *Num | Num | Secs | Bytes | **Max | Drive
Name | Type | Trks |Sides| /Trk | /Disk | RDE | Type
------+-------+------+-----+------+-------+-------+------
MQD9 | MSDOS | 80 | 2 | 9 | 720K | 112 | 3 1/2
MD9 | MSDOS | 40 | 2 | 9 | 360K | 112 | 5 1/4
MS9 | MSDOS | 40 | 1 | 9 | 180K | 64 | 5 1/4
AD9 | ATARI | 80 | 2 | 9 | 720K | 112 | 3 1/2
AS9 | ATARI | 80 | 1 | 9 | 360K | 112 | 3 1/2
* 80 track formats not allowed on 40 track, 5 1/4" drives.
** RDE = root directory entries. One root directory entry
is used for the volume name.
To format a default disk from WORKBENCH, select the desired
MS-DOS disk icon then (with shift key held) double-click on
the MFormat icon. If no MS-DOS disk icon is available,
just double-click on the MFormat icon. It will then prompt
you for the name of the mounted MS-DOS device to format.
If you wish to specify a format other than the default from
WORKBENCH, select the desired MS-DOS disk icon then
double-click on the project icon with the desired format
type (such as "MSDOS_D9.MFormat").
The FMT, QUICK, FAST and NOVERIFY options are available as
5-5
CrossDOS ... The MS-DOS File System
TOOL TYPES parameters in the project icons.
5.7 "MDiskCopy"
Format:
MDiskCopy [FROM] <SRCdsk> TO <DSTdsk>
Template:
MDiskCopy "SRCDISK,DSTDISK"
Purpose:
Make a copy of an MS-DOS disk
Path:
SYS:System/MDiskCopy
Specification:
This utility will make a copy of an MS-DOS disk on another
mounted MS-DOS drive. MDiskCopy will not perform
single-drive copies.
The following is an example when using the command from the
CLI:
MDiskCopy DI0: TO DI1:
To copy disks from WORKBENCH, select the desired source
MS-DOS disk icon first, extend-select (with shift key held)
the destination MS-DOS disk icon next, then (with shift key
still held) double-click on the MDiskCopy icon.
If the MS-DOS disk icons are not displayed, just
double-click on the MDiskCopy icon and the program will
prompt you for the names of the mounted MS-DOS devices to
copy.
5.8 "Attach"
Format:
Attach <devicename>
Template:
Attach "DEVICENAME/A"
Purpose:
To "mount" and "load" an MS-DOS device.
Path:
MSDOS_FileSystem:Attach
Specification:
This utility attempts to "mount" and "load" an MS-DOS
device. This utility will only work with the installation
disk supplied (see NOTE).
The following is an example when using the command from the
CLI:
MSDOS_FileSystem:Attach DI0:
To Attach a device from WORKBENCH, double-click on the
Attach.<device> icon (such as "Attach.DI0") or double-click
on the Attach icon and the program will prompt you for the
name of the mounted MS-DOS device.
The DEVICENAME option is available as TOOL TYPES parameter
5-6
CrossDOS ... The MS-DOS File System
in the project icons.
Attach automatically executes the TDPatch command if
needed.
NOTE
Please use a copy of the original product disk
supplied. You can add files to it but do not modify
any of the files currently on the disk.
5.9 "TxFilter"
Format:
TxFilter <devicename> [ON|OFF]
Template:
TxFilter "DEVICENAME/A,ON/S,OFF/S"
Purpose:
To apply a CTRL-M and CTRL-Z filter on all files
transferred to and from the specified device.
Path:
SYS:System/TxFilter
Specification:
This utility attempts to apply a CTRL-M and CTRL-Z filter
on ALL files transferred to and from the specified device.
This utility is equivalent to using the "CTRL-M/CTRL-Z
Filter" character ']' within all MS-DOS filenames.
The program opens a window with a small button gadget
indicating the current status of the text filter for the
device. To toggle the filter into the opposite state,
select button gadget. To completely remove the text
filter, select the close gadget in the upper left corner of
the window.
The following is an example when using the command from the
CLI:
TxFilter DI0:
If the option of ON or OFF is not specified, the default is
OFF.
To TxFilter a device from WORKBENCH, double-click on the
TxFilter.<device> icon (such as "TxFilter.DI0") or
double-click on the TxFilter icon and the program will
prompt you for the name of the mounted MS-DOS device.
The DEVICENAME option is available as TOOL TYPES parameter
in the project icons.
5-7
CrossDOS ... The MS-DOS File System
5.10 "IntlTrans"
Format:
IntlTrans <devicename> [ON|OFF]
Template:
IntlTrans "DEVICENAME/A,ON/S,OFF/S"
Purpose:
To apply an International translation on all files
transferred to and from the specified device.
Path:
SYS:System/IntlTrans
Specification:
This utility attempts to apply an International translation
on ALL files transferred to and from the specified device.
This utility is equivalent to using the "International
Translator" character '[' (formerly the "High Bit
Filter") within all MS-DOS filenames. This function will
ONLY work when the International version of the file system
"MSDOSFileSystem.INTL" is used.
The program opens a window with a small button gadget
indicating the current status of the translator for the
device. To toggle the translator into the opposite state,
select button gadget. To completely remove the translator,
select the close gadget in the upper left corner of the
window.
The following is an example when using the command from the
CLI:
IntlTrans DI0:
If the option of ON or OFF is not specified, the default is
OFF.
To IntlTrans a device from WORKBENCH, double-click on the
IntlTrans icon and the program will prompt you for the name
of the mounted MS-DOS device. You may use the TxFilter
utility to do the same thing.
5.11 "DiskChg"
Format:
DiskChg <devicename>
Template:
DiskChg "DEVICENAME/A"
Purpose:
To force a "diskchange" on the specified device.
Path:
SYS:System/DiskChg
Specification:
This utility forces a "diskchange" on the specified
device. This command is useful for forcing a diskchange on
5 1/4" floppy drives because they do not have the hardware
to support automatic diskchanges. This command can also be
used on any disk device including hard drives.
The following is an example when using the command from the
CLI:
5-8
CrossDOS ... The MS-DOS File System
DiskChg DI0:
To DiskChg a device from WORKBENCH, double-click on the
DiskChg.<device> icon (such as "DiskChg.DI0") or
double-click on the DiskChg icon and the program will
prompt you for the name of the mounted MS-DOS device.
The DEVICENAME option is available as TOOL TYPES parameter
in the project icons.
5.12 "TDPatch12 or TDPatch13"
Format:
TDPatch12 or TDPatch13
Template:
TDPatch12 or TDPatch13
Purpose:
Patch the trackdisk.device for V1.2 or V1.3 ROMs
Path:
C:TDPatch12 or TDPatch13
Specification:
TDPatch12 or TDPatch13 will patch the trackdisk.device code
for Kickstart ROMs V1.2 or V1.3 respectively. This patch
is needed because of a couple bugs in the trackdisk code
supplied by Commodore that are not patched with
"SetPatch". The patch also supplies a feature in the
trackdisk code that is found in V2.0 Kickstart ROMs but not
in the eariler versions. This feature is needed to provide
CrossDOS with faster floppy data access.
The installation program will detect your Kickstart version
and install the proper patch command to your system disk.
This patch will be automatically executed with the
"MountMF" and "Attach" commands. CrossDOS WILL NOT work
with floppies if this patch is not applied for users with
V1.2 and V1.3 ROMs.
5-9
CrossDOS ... The MS-DOS File System
w6 LEGAL ISSUES
w
6.1 COPYRIGHT
All software and documentation distributed in this product,
CrossDos Version 4.00b READONLY, Copyright (c) 1989,1990
CONSULTRON. All Rights Reserved.
The "READONLY" version of this product is distributed as
"freely-distributable" providing the following conditions
are met:
- All files present in the distribution package must be
redistributed with the package, including this
documentation file. If you distribute on diskette,
all files must be on a single diskette.
- The distributor may charge a fee to recover
distribution costs. The fee for diskette distribution
shall not exceed $7.00 (U.S.) unless given written
permission from CONSULTRON.
- The distributor agrees to cease distributing this
release or any subsequent releases if requested to do
so by CONSULTRON.
- This product or any portion thereof may not be
included in any commercial product without obtaining
licensing from CONSULTRON.
Software programs contained in this product that were
obtained from the "public domain" retain their own
copyrights. All effort was made to distribute this
software as it was received (where ever possible). This
software has been found to be very useful in the creation
of this product. I encourage the use of these
supplimentary software products and I also encourage
monetary remuneration where recommended.
6.2 DISCLAIMER
ALL EFFORT HAS BEEN MADE TO MAKE THIS PRODUCT, SOFTWARE AND
DOCUMENTATION, USEFUL AND ERROR FREE. SHOULD ANY ERRORS OR
PROBLEMS OCCUR, PLEASE CONTACT CONSULTRON PROMPTLY, IN
WRITING, STATING THE PROBLEM AS THOROUGHLY AS POSSIBLE.
THIS PRODUCT IS SOLD "AS IS" WITHOUT REPRESENTATION OR
WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
INCLUDING WITHOUT LIMITATION, ANY REPRESENTATIONS OR
ENDORSEMENTS REGARDING THE USE OF, THE RESULTS OF, OR
PERFORMANCE OF THE PRODUCT, ITS APPROPRIATENESS, ACCURACY,
RELIABILTY, OR CURRENTNESS. THE ENTIRE RISK AS TO THE USE
OF THE PRODUCT IS ASSUMED BY THE USER.
COPY-PROTECTED MEDIA USED WITH THIS PRODUCT MAY NOT
TRANSFER DATA PROPERLY AND WILL ALTER DATA UNFAVORABLY IF
THE MEDIA IS WRITTEN TO.
6-1
CrossDOS ... The MS-DOS File System
IN NO EVENT WILL CONSULTRON, ITS AFFILIATED COMPANIES, NOR
ITS EMPLOYEES, BE LIABLE FOR ANY DAMAGES, DIRECT, INDIRECT,
INCIDENTAL OR CONSEQUENTIAL, RESULTING FROM ANY DEFECT IN
THE PRODUCT, EVEN IF CONSULTRON HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
THIS DISCLAIMER SHALL SUPERSEDE ANY VERBAL OR WRITTEN
STATEMENT TO THE CONTRARY.
6.3 TRADEMARKS
CrossDos is a trademark of CONSULTRON.
CONSULTRON is a trademark of CONSULTRON.
Amiga is a registered trademark of Commodore-Amiga, Inc.
AmigaDOS, Amiga 500, Amiga 1000, Amiga 2000, Amiga 2000HD,
Transformer and WORKBENCH are trademarks of
Commodore-Amiga, Inc.
MS-DOS is a registered trademark of Microsoft Corp.
PC-DOS, IBM-AT, and PS/2 are registered trademarks of
International Business Machines Corp.
Atari ST is a registered trademark of Atari Corp.
6-2
CrossDOS ... The MS-DOS File System
w7 REVISION HISTORY
w
CrossDos versions prior to 3.01 are internally
distributed. Corrections were made in the following
versions:
Version 3.02
- 'Divide by zero' guru when doing "info" on non-MSDOS
disks.
- Improved sector detection and recovery.
- Better Canadian pricing ($40 -> $36) to reflect
current exchange rate.
- Improved documentation.
Version 3.03
- Eliminated 'Write Protect' requester when doing
ParentDir()s and some other DOS commands.
Version 3.04 (internal release)
Version 3.05
- Improved disk error requestor.
- Combined and reduced manual.
- Fixed TDPatch13.
- Better installation program
Version 3.05a (internal release)
Version 3.05b
- Made provision for use with C LTD. hard disk driver.
- Found code that caused random crashes particularly
when using ARP.
Version 3.06
- Fixed ".info" updating for WORKBENCH.
- Fixed problem with duplicate icon names across
directories.
- Added text filter button and utility.
- Added "Attach" utility.
- Improved "MFormat" and "MDiskCopy" commands for use
with WORKBENCH.
Version 3.06a (internal; not released)
Version 3.06b (internal; not released)
Version 3.06c
- Allowed tracks to re-reference if tracks "off track".
- Allowed for greater variance in disk drive speed for
data recovery.
- Made TDPatch12 or TDPatch13 mandatory.
Version 3.07
- International version of the file system.
Version 3.07a
7-1
CrossDOS ... The MS-DOS File System
- Support for devices that use > 512 byte sectors.
Version 4.00
- Faster floppy data access. Upto 2 times for
68000-based Amigas.
- Improved error handling
7-2
CrossDOS ... The MS-DOS File System
w8 MISCELLENEOUS SERVICES
w
The following are miscelleneous services provided by
CONSULTRON.
8.1 Dealer and Distributor Quantity Discounts
Dealer and Distributor quantity discounts are available.
Inquire by phoning the Technical Support line.
8.2 Licensing
Licensing of CrossDos in other commercial products is
available. We believe that many commercial applications
can benefit by the inclusion of this product particularly
where data formats are shared between the Amiga and MS-DOS
applications. Inquire by phoning the Technical Support
line.
8.3 Technical Support
Technical support is provided to answer any questions about
CrossDos. Should you exhibit any problems with either
release of the product, contact someone at the support line
for help or bug reports. Inquire by phoning the Technical
Support line.
Technical Support Line -- (313) 459-7271 9:00AM - 5:00PM EST
8-1
CrossDOS ... The MS-DOS File System
w9 ACKNOWLEDGEMENTS
w
I would like to acknowledge the following people for their
help and encouragement in the development of this
product.
I would like to thank William S. Hawes the creator of
ARexx, ConMan & WShell for his assistance in freely and
generously providing his time and information on creating
successful handler code. His cooperation as well as the
quality and usefulness of his products has encouraged me to
maintain a high quality standard for this product.
I would like to thank Software Distillery, particularly
John Toebes and Doug Walker for their articles in
Transactor for the Amiga magazine (Vol. 2 Iss. 2-3)
dealing with file systems. Although most of my file system
code was done by the time these articles came out, I found
their information useful in fine tuning it in a few
places.
I would like to thank my beta version testers for their
time and effort in the development of a robust product.
Their bug reports and suggestions have enhanced this
product significantly.
I would like to thank Jurgen Switalski for his V1.3
compatible "mount" command.
I would like to thank Orin Buck the creator Light Dreams of
for his help on revising this manual.
Last but definitely not least, I thank my Lord, Savior and
God for giving me the wisdom and opportunity to create this
product. Without His wisdom, this product would not
exist.
Thank you.
Leonard Poma; Author
9-1
CrossDOS ... The MS-DOS File System
w10 ORDER FORM
w
The pricing for CrossDos listed here is current for August
20th, 1990. We will try to maintain this pricing for this
product but we reserve the right to change this at any
time. The READ/WRITE version is shipping NOW. This
version will include all the necessary files on diskette
and a printed manual.
PRICING SCHEDULE for CrossDos
(includes disk and printed manual)
Location Price Shipping and Handling
================================================================
United States | $30.00 (US) + $3.00 (US)
Canada | $36.00 (CDN) + $3.00 (CDN)
Outside US and Canada | $30.00 (US funds)* + $8.00 (US funds)*
* drawn on a US bank.
Add $3.00 for C.O.D. orders (available in the US only)
QTY ORDERED PRODUCT Cost/unit Ext. Cost
================================================================
| CrossDOS -- MS-DOS | |
----------------------------------------------------------------
Michigan State Sales Tax = x 4% |
(Michigan residents only) |
----------------------------------------------------------------
| Shipping and Handling | |
----------------------------------------------------------------
C.O.D. (only in US) |
|------------
Total Cost |
|
Make all checks or money orders out to CONSULTRON.
(please allow up to 2 weeks to process your order)
Send the check and this order form to:
CONSULTRON
11280 Parkview
Plymouth, MI. 48170
SHIPPING INFORMATION
Name _______________________________________________________
Address ____________________________________________________
City _________________________ State/Province ______________
Country_______________________ Zip Code ____________________
10-1
TABLE OF CONTENTS
1 INTRODUCTION ............................... 1-1
1.1 Feature Summary ........................ 1-1
1.2 Hardware Requirements .................. 1-2
1.3 Software Requirements .................. 1-2
1.3.1 Minimum Files Needed ............... 1-2
1.4 Product Limitations .................... 1-2
2 "TRYWARE" .................................. 2-1
3 INSTALLATION ............................... 3-1
3.1 Backup Your Original Product Disk ......... 3-1
3.2 Installing CrossDOS .................... 3-1
3.2.1 Method 1 -- Immediate Use ............ 3-1
3.2.2 Method 2 -- System Installation ...... 3-1
3.2.3 Mounting an MS-DOS Device ........... 3-2
3.3 Double Track Step Mode ................... 3-2
4 AmigaDOS COMPATIBILITY ...................... 4-1
4.1 File Naming Conventions ................. 4-1
4.1.1 Invalid Characters ................ 4-1
4.1.2 File Name ("FileName") ............. 4-1
4.1.3 File Extension (".Ext") ............ 4-1
4.1.3.1 WORKBENCH Extension (".info") . 4-2
4.1.4 Root Name Qualifier (':') ........... 4-2
4.1.5 Volume Name ("Volume_Name") ........ 4-2
4.1.6 Directory Name Qualifiers ('/' or '\') 4-2
4.2 File Filters ........................... 4-3
4.2.1 CTRL-M/CTRL-Z Filter (']') ......... 4-3
4.2.2 High Bit Filter/Int'l Translator ('[') 4-3
4.3 Sensing Disk Changes .................... 4-4
5 FILE LIST ................................... 5-1
5.1 MS-DOS File System Support Utilities ...... 5-2
5.2 "MountMF" ............................. 5-2
5.3 "Mount_JDS" ........................... 5-2
5.4 "Kill" ................................ 5-3
5.5 "DiskChk" ............................. 5-4
5.6 "MFormat" ............................. 5-4
5.7 "MDiskCopy" ........................... 5-6
5.8 "Attach" .............................. 5-6
5.9 "TxFilter" ............................ 5-7
5.10 "IntlTrans" .......................... 5-7
5.11 "DiskChg" ............................ 5-8
5.12 "TDPatch12 or TDPatch13" ............... 5-9
6 LEGAL ISSUES ................................ 6-1
6.1 COPYRIGHT ............................. 6-1
6.2 DISCLAIMER ............................ 6-1
6.3 TRADEMARKS ............................ 6-2
7 REVISION HISTORY ............................ 7-1
8 MISCELLENEOUS SERVICES ...................... 8-1
8.1 Dealer and Distributor Quantity Discounts . 8-1
I
TABLE OF CONTENTS
8.2 Licensing ............................. 8-1
8.3 Technical Support ...................... 8-1
9 ACKNOWLEDGEMENTS ........................... 9-1
10 ORDER FORM ................................. 10-1
II